Creating the Configuration File
To run the ReplValidator utility you must have a valid .xml configuration file that lists the sites and services to be compared, and how validation between the primary (source) services and the replicated (destination) services will be performed. The ReplValidation configuration file also defines an output file location, the number of simultaneous comparisons, whether to autostart, the maximum number of records to compare, the maximum number of missing records, the number of iterations, how to iterate, and any table exclusions.
See the following subsections for more information:
- Create or Edit Configuration
- Configure Options
- Configure Exclusions
- Property Definitions
- Sample Configuration File
To Create or Edit a Configuration File
- Select File > Create Config… (or Ctrl+C) to create a new configuration file or
select File > Open Config… (or Ctrl+O or click
(Open Config) on the toolbar) to open a previously created configuration file or
select File > Edit Config… (or Ctrl+E) to edit an open configuration file to view the Create/Edit Configuration dialog box. - Configure the settings on the Create/Edit Configuration dialog box using the properties described below.
- The Replication Sites pane is where you add, edit, and delete the replication sites to be compared:
- Click Add Site or Edit Site to add a site and configure the following properties for each site (described below):
  |
| Configuration File Add / Edit Site |
- Click OK to accept the properties. The Replication Sites and Replication Services information will be added to the two panes of the Create/Edit Configuration dialog box.
- Click Delete to remove a site from the configuration.
- To specify automatic validation once configuration is complete, click Auto Update within the Replication Sites pane. Note the following:
- If Auto Update is selected, the ReplValidator will evaluate site replication even if the services are offline
- If Auto Update is not selected, the ReplValidator will evaluate site replication only when the services are online
- To exclude a site pair from validation, clear the check box on the left of the Replication Sites pane.
- If you have more than one site pair in the Replication Sites pane you can reorder them using the +/- keys on your keyboard.
|
| Create / Edit Configuration |
- To exclude a service pair from validation, clear the check box on the left of the Replication Services pane.
- To reorder the service pairs use the +/- keys on your keyboard.
- Select a service pair and click Options to configure record and iteration option for that service. The properties are described below.
|
| Configuration File Options |
Note: This option only applies to DBS-Based Services. The button is disabled for non-DBS services.
|
| Configuration File DBS Table Exclusions |
- When done, click Save As to access the Save As dialog box to type a file name and specify the directory location to which to save the .xml configuration file
Create/Edit Configuration
The properties on the Create/Edit Configuration dialog box are described in the following table.
| Parameter | Required | Default Value | Description | XML Attribute |
|---|---|---|---|---|
|
Summary Log File |
Yes |
.\Summary.log |
The directory location where the summary log files will be saved. Note: Change this property to avoid writing the log files to the same folder from where ReplValidator.exe is run. |
SummFile |
|
# Simul. Validations |
Yes |
5 |
The number of simultaneous validation comparisons to be performed at any time. |
MaxRunningSites |
|
Autostart |
No |
not selected |
Indicates whether to start comparing sites automatically once validation is configured and saved. |
AutoStart |
Replication Sites > Add Site / Edit Site
The properties on the Add / Edit Site dialog box are described in the following table.
| Parameter | Required | Default Value | Description | XML Attribute |
|---|---|---|---|---|
|
Common Site Name |
Yes |
- |
The site name of the primary and replicated services, which must be the same. |
|
|
Primary Site |
Yes |
- |
The name of the primary site. Will be grayed out if the Common Site Name is populated. |
PriSiteName |
|
Replicated Site |
Yes |
- |
The name of the replicated site. Will be grayed out if the Common Site Name is populated. |
ReplSiteName |
|
Primary Domain |
Yes |
- |
The Domain ID of the primary site. |
PriDomain |
|
Replicated Domain |
Yes |
- |
The Domain ID of the replicated site. |
ReplDomain |
Replication Services > Options
The properties on the Options dialog box are described in the following table.
| Parameter | Required | Default Value | Description | XML Attribute |
|---|---|---|---|---|
|
Description |
No |
<site>.<service> (<pri domain>, <sec domain>) |
A description of service and domains to be compared. |
Desc |
|
Log File Path/Name |
No |
.\<site>_<service>_<pri domain>_<sec domain>.log |
The directory location where the logging and results for the service will be saved. Note: Change this property to avoid writing the log files to the same folder from where ReplValidator.exe is run. |
OutputFile |
|
Max. Records |
No |
Ignored, compares entire database |
The maximum number of records to compare. |
MaxRecs |
|
Max. Missing Recs |
No |
Ignore, compare entire database |
If the number of mismatches reaches this number, then the comparison for that service will stop. |
MaxMisAllowed |
|
Num. Iterations |
No |
1 |
The number of times to compare the services. |
NumIters |
|
Reverse Iteration |
No |
not selected |
If selected (true), the database records will be compared newest to oldest. Most often used for the ELS and AUD services. If not selected (false), the database records will be compared oldest to newest. |
RevIter |
Sample Configuration File
The following example configuration file was generated by the ReplValidator.
|
Click the thumbnail to see a sample |
